<?php
/**
 * CodeIgniter
 *
 * An open source application development framework for PHP
 *
 * This content is released under the MIT License (MIT)
 *
 * Copyright (c) 2014 - 2017, British Columbia Institute of Technology
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 * @package	CodeIgniter
 * @author	EllisLab Dev Team
 * @copyright	Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
 * @copyright	Copyright (c) 2014 - 2017, British Columbia Institute of Technology (http://bcit.ca/)
 * @license	http://opensource.org/licenses/MIT	MIT License
 * @link	https://codeigniter.com
 * @since	Version 1.0.0
 * @filesource
 */
defined('BASEPATH') or exit('No direct script access allowed');

/**
 * Jquery Class
 *
 * @package CodeIgniter
 * @subpackage Libraries
 * @category Loader
 * @author EllisLab Dev Team
 * @link https://codeigniter.com/user_guide/libraries/javascript.html
 */
class CI_Jquery extends CI_Javascript
{

    /**
     * JavaScript directory location
     *
     * @var string
     */
    protected $_javascript_folder = 'js';

    /**
     * JQuery code for load
     *
     * @var array
     */
    public $jquery_code_for_load = array();

    /**
     * JQuery code for compile
     *
     * @var array
     */
    public $jquery_code_for_compile = array();

    /**
     * JQuery corner active flag
     *
     * @var bool
     */
    public $jquery_corner_active = FALSE;

    /**
     * JQuery table sorter active flag
     *
     * @var bool
     */
    public $jquery_table_sorter_active = FALSE;

    /**
     * JQuery table sorter pager active
     *
     * @var bool
     */
    public $jquery_table_sorter_pager_active = FALSE;

    /**
     * JQuery AJAX image
     *
     * @var string
     */
    public $jquery_ajax_img = '';
    
    // --------------------------------------------------------------------
    
    /**
     * Constructor
     *
     * @param array $params            
     * @return void
     */
    public function __construct($params)
    {
        $this->CI = & get_instance();
        extract($params);
        
        if ($autoload === TRUE) {
            $this->script();
        }
        
        log_message('info', 'Jquery Class Initialized');
    }
    
    // --------------------------------------------------------------------
    // Event Code
    // --------------------------------------------------------------------
    
    /**
     * Blur
     *
     * Outputs a jQuery blur event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _blur($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'blur');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Change
     *
     * Outputs a jQuery change event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _change($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'change');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Click
     *
     * Outputs a jQuery click event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @param
     *            bool whether or not to return false
     * @return string
     */
    protected function _click($element = 'this', $js = '', $ret_false = TRUE)
    {
        is_array($js) or $js = array(
            $js
        );
        
        if ($ret_false) {
            $js[] = 'return false;';
        }
        
        return $this->_add_event($element, $js, 'click');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Double Click
     *
     * Outputs a jQuery dblclick event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _dblclick($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'dblclick');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Error
     *
     * Outputs a jQuery error event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _error($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'error');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Focus
     *
     * Outputs a jQuery focus event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _focus($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'focus');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Hover
     *
     * Outputs a jQuery hover event
     *
     * @param
     *            string - element
     * @param
     *            string - Javascript code for mouse over
     * @param
     *            string - Javascript code for mouse out
     * @return string
     */
    protected function _hover($element = 'this', $over = '', $out = '')
    {
        $event = "\n\t$(" . $this->_prep_element($element) . ").hover(\n\t\tfunction()\n\t\t{\n\t\t\t{$over}\n\t\t}, \n\t\tfunction()\n\t\t{\n\t\t\t{$out}\n\t\t});\n";
        
        $this->jquery_code_for_compile[] = $event;
        
        return $event;
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Keydown
     *
     * Outputs a jQuery keydown event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _keydown($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'keydown');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Keyup
     *
     * Outputs a jQuery keydown event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _keyup($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'keyup');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Load
     *
     * Outputs a jQuery load event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _load($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'load');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Mousedown
     *
     * Outputs a jQuery mousedown event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _mousedown($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'mousedown');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Mouse Out
     *
     * Outputs a jQuery mouseout event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _mouseout($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'mouseout');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Mouse Over
     *
     * Outputs a jQuery mouseover event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _mouseover($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'mouseover');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Mouseup
     *
     * Outputs a jQuery mouseup event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _mouseup($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'mouseup');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Output
     *
     * Outputs script directly
     *
     * @param array $array_js
     *            array()
     * @return void
     */
    protected function _output($array_js = array())
    {
        if (! is_array($array_js)) {
            $array_js = array(
                $array_js
            );
        }
        
        foreach ($array_js as $js) {
            $this->jquery_code_for_compile[] = "\t" . $js . "\n";
        }
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Resize
     *
     * Outputs a jQuery resize event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _resize($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'resize');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Scroll
     *
     * Outputs a jQuery scroll event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _scroll($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'scroll');
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Unload
     *
     * Outputs a jQuery unload event
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @return string
     */
    protected function _unload($element = 'this', $js = '')
    {
        return $this->_add_event($element, $js, 'unload');
    }
    
    // --------------------------------------------------------------------
    // Effects
    // --------------------------------------------------------------------
    
    /**
     * Add Class
     *
     * Outputs a jQuery addClass event
     *
     * @param string $element            
     * @param string $class            
     * @return string
     */
    protected function _addClass($element = 'this', $class = '')
    {
        $element = $this->_prep_element($element);
        return '$(' . $element . ').addClass("' . $class . '");';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Animate
     *
     * Outputs a jQuery animate event
     *
     * @param string $element            
     * @param array $params            
     * @param string $speed
     *            'fast', or time in milliseconds
     * @param string $extra            
     * @return string
     */
    protected function _animate($element = 'this', $params = array(), $speed = '', $extra = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        $animations = "\t\t\t";
        
        foreach ($params as $param => $value) {
            $animations .= $param . ": '" . $value . "', ";
        }
        
        $animations = substr($animations, 0, - 2); // remove the last ", "
        
        if ($speed !== '') {
            $speed = ', ' . $speed;
        }
        
        if ($extra !== '') {
            $extra = ', ' . $extra;
        }
        
        return "$({$element}).animate({\n$animations\n\t\t}" . $speed . $extra . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Fade In
     *
     * Outputs a jQuery hide event
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _fadeIn($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return "$({$element}).fadeIn({$speed}{$callback});";
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Fade Out
     *
     * Outputs a jQuery hide event
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _fadeOut($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return '$(' . $element . ').fadeOut(' . $speed . $callback . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Hide
     *
     * Outputs a jQuery hide action
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _hide($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return "$({$element}).hide({$speed}{$callback});";
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Remove Class
     *
     * Outputs a jQuery remove class event
     *
     * @param string $element            
     * @param string $class            
     * @return string
     */
    protected function _removeClass($element = 'this', $class = '')
    {
        $element = $this->_prep_element($element);
        return '$(' . $element . ').removeClass("' . $class . '");';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Slide Up
     *
     * Outputs a jQuery slideUp event
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _slideUp($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return '$(' . $element . ').slideUp(' . $speed . $callback . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Slide Down
     *
     * Outputs a jQuery slideDown event
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _slideDown($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return '$(' . $element . ').slideDown(' . $speed . $callback . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Slide Toggle
     *
     * Outputs a jQuery slideToggle event
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _slideToggle($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return '$(' . $element . ').slideToggle(' . $speed . $callback . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Toggle
     *
     * Outputs a jQuery toggle event
     *
     * @param
     *            string - element
     * @return string
     */
    protected function _toggle($element = 'this')
    {
        $element = $this->_prep_element($element);
        return '$(' . $element . ').toggle();';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Toggle Class
     *
     * Outputs a jQuery toggle class event
     *
     * @param string $element            
     * @param string $class            
     * @return string
     */
    protected function _toggleClass($element = 'this', $class = '')
    {
        $element = $this->_prep_element($element);
        return '$(' . $element . ').toggleClass("' . $class . '");';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Show
     *
     * Outputs a jQuery show event
     *
     * @param
     *            string - element
     * @param
     *            string - One of 'slow', 'normal', 'fast', or time in milliseconds
     * @param
     *            string - Javascript callback function
     * @return string
     */
    protected function _show($element = 'this', $speed = '', $callback = '')
    {
        $element = $this->_prep_element($element);
        $speed = $this->_validate_speed($speed);
        
        if ($callback !== '') {
            $callback = ", function(){\n{$callback}\n}";
        }
        
        return '$(' . $element . ').show(' . $speed . $callback . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Updater
     *
     * An Ajax call that populates the designated DOM node with
     * returned content
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string the controller to run the call against
     * @param
     *            string optional parameters
     * @return string
     */
    protected function _updater($container = 'this', $controller = '', $options = '')
    {
        $container = $this->_prep_element($container);
        $controller = (strpos('://', $controller) === FALSE) ? $controller : $this->CI->config->site_url($controller);
        
        // ajaxStart and ajaxStop are better choices here... but this is a stop gap
        if ($this->CI->config->item('javascript_ajax_img') === '') {
            $loading_notifier = 'Loading...';
        } else {
            $loading_notifier = '<img src="' . $this->CI->config->slash_item('base_url') . $this->CI->config->item('javascript_ajax_img') . '" alt="Loading" />';
        }
        
        $updater = '$(' . $container . ").empty();\n" . // anything that was in... get it out
"\t\t$(" . $container . ').prepend("' . $loading_notifier . "\");\n"; // to replace with an image
        
        $request_options = '';
        if ($options !== '') {
            $request_options .= ', {' . (is_array($options) ? "'" . implode("', '", $options) . "'" : "'" . str_replace(':', "':'", $options) . "'") . '}';
        }
        
        return $updater . "\t\t$($container).load('$controller'$request_options);";
    }
    
    // --------------------------------------------------------------------
    // Pre-written handy stuff
    // --------------------------------------------------------------------
    
    /**
     * Zebra tables
     *
     * @param string $class            
     * @param string $odd            
     * @param string $hover            
     * @return string
     */
    protected function _zebraTables($class = '', $odd = 'odd', $hover = '')
    {
        $class = ($class !== '') ? '.' . $class : '';
        $zebra = "\t\$(\"table{$class} tbody tr:nth-child(even)\").addClass(\"{$odd}\");";
        
        $this->jquery_code_for_compile[] = $zebra;
        
        if ($hover !== '') {
            $hover = $this->hover("table{$class} tbody tr", "$(this).addClass('hover');", "$(this).removeClass('hover');");
        }
        
        return $zebra;
    }
    
    // --------------------------------------------------------------------
    // Plugins
    // --------------------------------------------------------------------
    
    /**
     * Corner Plugin
     *
     * @link http://www.malsup.com/jquery/corner/
     * @param string $element            
     * @param string $corner_style            
     * @return string
     */
    public function corner($element = '', $corner_style = '')
    {
        // may want to make this configurable down the road
        $corner_location = '/plugins/jquery.corner.js';
        
        if ($corner_style !== '') {
            $corner_style = '"' . $corner_style . '"';
        }
        
        return '$(' . $this->_prep_element($element) . ').corner(' . $corner_style . ');';
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Modal window
     *
     * Load a thickbox modal window
     *
     * @param string $src            
     * @param bool $relative            
     * @return void
     */
    public function modal($src, $relative = FALSE)
    {
        $this->jquery_code_for_load[] = $this->external($src, $relative);
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Effect
     *
     * Load an Effect library
     *
     * @param string $src            
     * @param bool $relative            
     * @return void
     */
    public function effect($src, $relative = FALSE)
    {
        $this->jquery_code_for_load[] = $this->external($src, $relative);
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Plugin
     *
     * Load a plugin library
     *
     * @param string $src            
     * @param bool $relative            
     * @return void
     */
    public function plugin($src, $relative = FALSE)
    {
        $this->jquery_code_for_load[] = $this->external($src, $relative);
    }
    
    // --------------------------------------------------------------------
    
    /**
     * UI
     *
     * Load a user interface library
     *
     * @param string $src            
     * @param bool $relative            
     * @return void
     */
    public function ui($src, $relative = FALSE)
    {
        $this->jquery_code_for_load[] = $this->external($src, $relative);
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Sortable
     *
     * Creates a jQuery sortable
     *
     * @param string $element            
     * @param array $options            
     * @return string
     */
    public function sortable($element, $options = array())
    {
        if (count($options) > 0) {
            $sort_options = array();
            foreach ($options as $k => $v) {
                $sort_options[] = "\n\t\t" . $k . ': ' . $v;
            }
            $sort_options = implode(',', $sort_options);
        } else {
            $sort_options = '';
        }
        
        return '$(' . $this->_prep_element($element) . ').sortable({' . $sort_options . "\n\t});";
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Table Sorter Plugin
     *
     * @param
     *            string table name
     * @param
     *            string plugin location
     * @return string
     */
    public function tablesorter($table = '', $options = '')
    {
        $this->jquery_code_for_compile[] = "\t$(" . $this->_prep_element($table) . ').tablesorter(' . $options . ");\n";
    }
    
    // --------------------------------------------------------------------
    // Class functions
    // --------------------------------------------------------------------
    
    /**
     * Add Event
     *
     * Constructs the syntax for an event, and adds to into the array for compilation
     *
     * @param
     *            string The element to attach the event to
     * @param
     *            string The code to execute
     * @param
     *            string The event to pass
     * @return string
     */
    protected function _add_event($element, $js, $event)
    {
        if (is_array($js)) {
            $js = implode("\n\t\t", $js);
        }
        
        $event = "\n\t$(" . $this->_prep_element($element) . ').' . $event . "(function(){\n\t\t{$js}\n\t});\n";
        $this->jquery_code_for_compile[] = $event;
        return $event;
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Compile
     *
     * As events are specified, they are stored in an array
     * This function compiles them all for output on a page
     *
     * @param string $view_var            
     * @param bool $script_tags            
     * @return void
     */
    protected function _compile($view_var = 'script_foot', $script_tags = TRUE)
    {
        // External references
        $external_scripts = implode('', $this->jquery_code_for_load);
        $this->CI->load->vars(array(
            'library_src' => $external_scripts
        ));
        
        if (count($this->jquery_code_for_compile) === 0) {
            // no inline references, let's just return
            return;
        }
        
        // Inline references
        $script = '$(document).ready(function() {' . "\n" . implode('', $this->jquery_code_for_compile) . '});';
        
        $output = ($script_tags === FALSE) ? $script : $this->inline($script);
        
        $this->CI->load->vars(array(
            $view_var => $output
        ));
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Clear Compile
     *
     * Clears the array of script events collected for output
     *
     * @return void
     */
    protected function _clear_compile()
    {
        $this->jquery_code_for_compile = array();
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Document Ready
     *
     * A wrapper for writing document.ready()
     *
     * @param array $js            
     * @return void
     */
    protected function _document_ready($js)
    {
        is_array($js) or $js = array(
            $js
        );
        
        foreach ($js as $script) {
            $this->jquery_code_for_compile[] = $script;
        }
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Script Tag
     *
     * Outputs the script tag that loads the jquery.js file into an HTML document
     *
     * @param string $library_src            
     * @param bool $relative            
     * @return string
     */
    public function script($library_src = '', $relative = FALSE)
    {
        $library_src = $this->external($library_src, $relative);
        $this->jquery_code_for_load[] = $library_src;
        return $library_src;
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Prep Element
     *
     * Puts HTML element in quotes for use in jQuery code
     * unless the supplied element is the Javascript 'this'
     * object, in which case no quotes are added
     *
     * @param
     *            string
     * @return string
     */
    protected function _prep_element($element)
    {
        if ($element !== 'this') {
            $element = '"' . $element . '"';
        }
        
        return $element;
    }
    
    // --------------------------------------------------------------------
    
    /**
     * Validate Speed
     *
     * Ensures the speed parameter is valid for jQuery
     *
     * @param
     *            string
     * @return string
     */
    protected function _validate_speed($speed)
    {
        if (in_array($speed, array(
            'slow',
            'normal',
            'fast'
        ))) {
            return '"' . $speed . '"';
        } elseif (preg_match('/[^0-9]/', $speed)) {
            return '';
        }
        
        return $speed;
    }
}
